CustomActions.install()

Доступность

Flash Player 6.

Синтаксис

CustomActions.install(customName:String, customXML:String) : Boolean

Параметры

customName Имя пользовательского действия (custom action) которое нужно установить..

customXML Текст, который долже быть установлен в описывающий файл XML.

Возвращает

Булево (Boolean) значение false если происходит ошибка в поцесс установки. Значение true возвращается, если пользовательское действие (custom action) успешно установлено.

Описание

Метод, устанавливает новый описывающий XML файл пользовательского действия, определенный в параметре customActionsName . Содержание файла задается параметром customXML в виде строки (String).

Имя файла, описывающего пользовательские действия, должно быть простым именем файла, без расширения .xml и без каких-либо разделителей (':', '/' или '\').

Если пользовательское действие с именем customName уже существует, оно перезаписывается.

Если папка Configuration/ActionsPanel/CustomActions не существует когда этот метод вызван, она будет создана.

Пример

Следующий пример показывает, как передать информацию в окно встроенного редактора actionscript из XML файла. Откройте текстовой редактор и сохраните новый документ под именем doglass.xml. документ скопируйте этот код:

<?xml version="1.0"?>
<customactions>
  <actionspanel>
    <folder version="7" id="DogClass" index="true" name="Dog" tiptext="Dog Class">
      <string version="7" id="getFleas" name="getFleas" tiptext="gets number of fleas" text=".getFleas(% fleas %)" />
    </folder>
  </actionspanel>
  <colorsyntax>
      <identifier text=".getFleas" />
  </colorsyntax>
  <codehints>
      <typeinfo pattern="*_dog" object="Dog"/>
  </codehints>
</customactions>

Затем создайте новый FLA файл в той же директории и в первый кадр таймлайна скопируйте этот код:

var my_xml:XML = new XML();
my_xml.ignoreWhite = true;
my_xml.onLoad = function(success:Boolean) {
  trace(success);
  CustomActions.install("dogclass", this.firstChild);
  trace(CustomActions.list());
};
my_xml.load("dogclass.xml");

Выберете Control>Test Movie и, если XML файл загрузился, в окне Output вы увидете true и массив, содержащий имена всех пользовательский действий, которые были зарегистрированы в среде разработки Flash. Закройте SWF файл, и откройте окно встроенного редактора actionscript. Вы найдете новый пункт в инструментальной панели (Actions toolbox), называющийся Dog , и внутри этой папки вы увидите getFleas.

Посмотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление